Skip to main content

6. Git Ignore

.gitignore 文件用于告诉 Git 哪些文件不应该被提交到版本控制中。这通常包括临时文件、编译产物、依赖包、缓存文件等。

✅ .gitignore 配置规则说明​

  • 每一行代表一个忽略的模式
  • 可以使用 * 通配符
  • 以 / 开头表示从项目根路径开始匹配
  • 以 ! 开头表示“不过滤”某些文件（优先级更高）
# 忽略所有 .log 文件
*.log

# 忽略 node_modules 目录
node_modules/

# 忽略 .env 文件
.env

# 不忽略 .env.sample
!.env.sample

📦 主流项目的 .gitignore 示例​

# Python 缓存
__pycache__/
*.py[cod]
*.pyo
*.egg-info/

# 虚拟环境
venv/
env/

# Jupyter Notebook 输出
.ipynb_checkpoints/

# IDE 配置
.vscode/
*.swp

🧪 特殊文件和忽略建议​

常见忽略建议
  • IDE 文件如 .vscode/, .idea/
  • 系统文件如 .DS_Store, Thumbs.db
  • OS 特定缓存，如 macOS .AppleDouble
  • 锁文件（如非必要）：
    • JS 项目建议保留 package-lock.json
    • Python 项目使用 requirements.txt

📌 .gitignore 生效说明​

info

.gitignore 只对尚未被 Git 跟踪的文件生效。

若文件已被 Git 跟踪，修改 .gitignore 后仍需移除缓存：

git rm -r --cached node_modules/

🧠 快捷方式​

GitHub 官方模板仓库​

可以快速获取 .gitignore 模板：

使用方式（以 React 为例）：

curl -L https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore -o .gitignore

✅ 总结​

  • .gitignore 是 Git 管理中重要的一环，用于排除不应提交的文件；
  • 不同项目应配置专属忽略项；
  • 注意 IDE 缓存、环境文件、构建目录等通用规则；
  • .gitignore 修改后需清除已跟踪缓存使其生效。

📚 推荐资源​